home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / winprogs / hgopher / readme.txt < prev   
Text File  |  1994-10-25  |  13KB  |  365 lines
  1.           README for HGOPHER  (Hampson's Gopher) 
  2.  
  3.     A Gopher Client For Windows 3.1  Version 2.3
  4.  
  5.  
  6. Welcome
  7.  
  8. This is a Gopher+ Client for windows 3.1.
  9.  
  10. This is the first non Beta release. But that does not mean there
  11. ain't no bugs in it -- it just means it been out for quite a while.
  12.  
  13. Send comments or problems on this product to m.hampson@ic.ac.uk
  14.  
  15. For information on winsock consult alt.winsock
  16. For information on gopher  consult comp.infosystems.gopher
  17. For information on PC NFS  consult com.protocols.nfs
  18.  
  19. HGopher now has online help. Please read the on line help section 
  20. called  "read this first" at least.
  21.  
  22. Bug Fixes since Beta 2.2
  23.  
  24.     * The annoying hgopher.ini has to be in the windows directory
  25.           problem has gone. HGopher now looks in the windows directory
  26.           (for backward compatibility) failing that it look in the working
  27.           directory (working directory from program manager). Failing
  28.           that it shouts loudly.
  29.  
  30.         * Mail format files are now understood.
  31.  
  32.         * Veronica premature EOF now handled.
  33.  
  34.         * WAIS indexes marked as directories now handled.
  35.  
  36.         * Empty directory don't cause HGopher to moan about bad entry
  37.  
  38.         * dot stuffing works on ASK block file uploads
  39.  
  40.         * Closing works the same as exit (ie it shuts down all connections)
  41.  
  42.         * if you exit maximized HGopher does not take over the screen
  43.  
  44.         * Lots of little other thing I can't remember about now.
  45.  
  46. New features since Beta 2.3
  47.  
  48.  
  49.     * HGopher now comes with a CSO Viewer called HGCSO.
  50.  
  51.         * You can now obtain info on the server.
  52.  
  53.         * You can decide when the Multiview symbol will be shown.
  54.  
  55.         * INFO, Admin and Abstracts can be viewed in a viewer of you choice.
  56.  
  57.         * Dot stuffing method changeable.
  58.  
  59.         * Supports Panda I Type.
  60.  
  61.         * recognizes HTML documents.
  62.  
  63.         * You can set the Main Menu Font.
  64.  
  65.         * Percentage Feedback bars on items with estimated size.
  66.  
  67.         * Search String can be a parameter
  68.  
  69.         * Copy to file now presents a reasonable file name.
  70.  
  71.         * New copy to Directory mode.
  72.  
  73.         * Now can force files to be saved with extension of you choice.
  74.  
  75.         * Can add new view types without leaving HGopher.
  76.     
  77. Requirements
  78.     
  79.     WINSOCK VERSION
  80.  
  81.     * MS Windows 3.1  (not tested with Windows 3.0)
  82.       Or Windows NT.
  83.     * Winsock DLL and TCP/IP+Packet support layer.
  84.     * See later for a list of Winsock tested versions.
  85.  
  86.     PC NFS VERSION
  87.     
  88.     * MS Windows 3.1 (not tested with Windows 3.0)
  89.     * PC NFS Version 4 or version 5 (may work with other versions)
  90.           NOTE: you can also use the Winsock version with PC NFS 5.0
  91.                 and I suggest you do, as support for the native PC NFS
  92.                 version may be withdrawn at some point.
  93.  
  94.  
  95. Installation
  96.  
  97.     Available for ANON FTP from lister.cc.ic.ac.uk
  98.         
  99.     Change to directory pub/wingopher and collect one of the files
  100.  
  101.     hgopher2.3.zip   [Winsock Version]      (Binary mode required)
  102.     hngopher2.3.zip  [Sun PC NFS Version]   (Binary mode required)
  103.  
  104.  
  105.         Unzip the package you have chosen to get 
  106.         hgopher.exe / hngopher.exe        Gopher program
  107.         hgopher.hlp                Online help
  108.         hgcso.exe / hngcso.exe            CSO Viewer
  109.         hgopher.ini                All the defaults
  110.         default.gbm                Some book marks
  111.         readme.txt                This file
  112.  
  113.  
  114.         Install these files in a directory of you choice. You should
  115.         make this the working directory when you run HGopher from
  116.         program manager.
  117.  
  118.         If you have an existing 2.2 hgopher.ini in your windows directory
  119.         HGopher 2.3 will use that. Else it will use the one in the working
  120.         directory. Old Version 1.0 and 1.1 ini files will cause HGopher 2.3
  121.         a major stress attack - get rid of them.
  122.  
  123.     You should also be able to get this product
  124.         from the following archives
  125.  
  126.     sunsite.unc.edu:<somewhere>        (Probably a day or two delay)
  127.         microdyne.com:/pub/winsock/apps                   ( or look in incoming)
  128.         boombox.micro.umn.edu:/pub/gopher/Windows       (or via their Gopher)
  129.         ftp.york.ac.uk:<somewhere>
  130.  
  131.         But make sure that you are getting the new 2.3 version (ie hgopher2.3.zip)
  132.  
  133.         You can also get HGopher from the "HGopher Information Centre", here's the
  134.         bookmark
  135.  
  136.     #
  137.         Type=1
  138.         Host=gopher.ic.ac.uk
  139.         Port=71
  140.         Path=1/HGopher Information
  141.         #
  142.         # Note the port - 71 NOT 70.
  143.  
  144. BTW If you entered the HGopher competition - This is your free copy :-)
  145.     the correct answers were:
  146.  
  147.     1 - Any
  148.     2 - Servers mis-configured
  149.     3 - False
  150.     4 - Ease of use
  151.     5 - Any
  152.     6 - C/C++
  153.  
  154.  
  155. Troubleshooting
  156.     
  157.     WINSOCK VERSION
  158.  
  159.     The first time you start it hgopher may not be able to 
  160.     connect to a server or will probably connect to the wrong
  161.     server
  162.     Use the Options  menu to config it as follows
  163.  
  164.     Gopher Options
  165.     
  166.     Set the name and path of your favorite gopher server
  167.  
  168.     Select a directory for temp files that already exists
  169.  
  170.     Hit the save button to save these setting between sessions
  171.     Hit the OK button to use these setting now
  172.  
  173.     use "go home" from the command menu to get the main menu 
  174.     from your default gopher.
  175.  
  176.     Network setup
  177.     
  178.     Set whether you are using DNS or the Vendor look up
  179.     service - If your vendor supports DNS lookup themselves
  180.     I suggest you use their service as the inbuilt DNS has
  181.     been shown not to work on some (most) Winsock versions. 
  182.  
  183.     If you are using the Winsock version with PC NFS you must
  184.         use the inbuilt DNS as Sun have not only not bothered to
  185.     implement DNS support but their own NIS does not function
  186.     with their Winsock either (at least at the release level
  187.     I have).
  188.     
  189.     If using the inbuilt DNS remember to use IP addresses and
  190.     not host names.
  191.  
  192.         WINSOCK USERS PLEASE NOTE - The file WINSOCK.DLL is required by this
  193.         program - if you don't have that file you are not running winsock.
  194.         WINSOCK.DLL does not come with HGopher, it is part of the network
  195.         package you are using. WINSOCK.DLL are NOT interchangable you must
  196.         use the correct one for your network stack. Public domain/ Shareware
  197.         WINSOCK stacks are beginning to appear - tune to alt.winsock to stay
  198.         in touch with what is going on in this field.
  199.  
  200.  
  201.     PC NFS VERSION
  202.  
  203.     Make sure at least RTM is loaded before you start Windows
  204.  
  205.     The first time you start it hngopher may not be able to 
  206.     connect to a server or will probably connect to the wrong
  207.     server
  208.     Use the Options menu to config it as follows
  209.  
  210.     Gopher Options
  211.     
  212.     Set the name and path of your favorite gopher server
  213.  
  214.     Select a directory for temp files that already exists
  215.  
  216.     Hit the save button to save these setting between sessions
  217.     Hit the OK button to use these setting now
  218.  
  219.     use "go home" from the command menu to get the main menu 
  220.     from your default gopher.
  221.  
  222.     Network setup
  223.     
  224.     Set whether you are using DNS or the Vendor name lookup
  225.     - with Sun this is NIS  - DNS is better.
  226.     Add up to 3 local DNS servers and your local domain
  227.     Hit OK. Remember to use IP addresses not hostnames.
  228.  
  229.  
  230. Usage
  231.  
  232.         For further usage information please read the online manual.
  233.         If you have any problems read the "read this first" section
  234.         of the manual.
  235.  
  236.     
  237. Winsock implementations tested against
  238.  
  239. The Beta 1.0 was tested against the following winsock implementations
  240.  
  241.     Lanera        - Verified to work
  242.     Distinct    - Verified to work
  243.     Netmange    - Believed to work
  244.     PC NFS 5.0      - Verified to work
  245.     PCTCP 2.11    - Verified to work
  246.     PCTCP 2.2    - Verified to work - However if you get a message
  247.               like PCTCPAPI052: get_kernel_info: Bad net_dope
  248.                           structure 0x1ae01197, try getting a newer version
  249.                   of their winsoc dll via ANON ftp
  250.               vax.ftp.com:/pub/winsockapi/FTPSoftware/winsock.dll.
  251.     SuperTcp 3.56   - Verified to work
  252.     Windows NT      - Verified to work under Beta version
  253.         Wintrumpet Socket version 1.00 alpha #12  Verified to work
  254.     Wollongong Pathway for DOS Runtime Release 1.2.0.1 with fix c42992a.exe
  255.  
  256. The Beta 2.2 version has only been tested with
  257.  
  258.     PC NFS Version 5
  259.         Novell  Lan WorkPlace for DOS Ver 4.1 (Patch level N)
  260.         ( Special thanks to Brian Meek of Novell for making this software
  261.           available to me).
  262.  
  263. Known Bugs
  264.  
  265.         Bug #4 Problem co existing with Vista Exceed
  266.            ( increase heap size to 64 to get around this)
  267.     Bug #5 Inbuilt DNS fails under some Winsock Implementations
  268.                ( Probably not both to fix this)
  269.         Bug #8 When iconized during a transfer fails to get some message
  270.                can result in a "dancing gopher".
  271.         Bug #9 Occasional "not present faults"
  272.  
  273.  
  274.  
  275.  
  276. ----------------------------------------------------------------------------
  277.     CopyRight notices 
  278.  
  279.     This version of gopher is not available in source code
  280.     form, however future versions maybe.
  281. ----------------------------------------------------------------------------
  282.  
  283.  * Copyright (c) 1993  Martyn Hampson
  284.  * All rights reserved.
  285.  *
  286.  * Redistribution and use in source and binary forms, with or without
  287.  * modification, are permitted provided that the following conditions
  288.  * are met:
  289.  * 1. Redistributions of source code must retain the above copyright
  290.  *    notice, this list of conditions and the following disclaimer.
  291.  * 2. Redistributions in binary form must reproduce the above copyright
  292.  *    notice, this list of conditions and the following disclaimer in the
  293.  *    documentation and/or other materials provided with the distribution.
  294.  * 3. All advertising materials mentioning features or use of this software
  295.  *    must display the following acknowledgement:
  296.  *    This product includes software developed by Martyn Hampson
  297.  * 4. The name Martyn Hampson
  298.  *    may NOT be used to endorse or promote products derived from this software
  299.  *    without specific prior written permission.
  300.  *
  301.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND
  302.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  303.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  304.  * ARE DISCLAIMED.  IN NO EVENT SHALL Martyn Hampson  BE LIABLE
  305.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  306.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  307.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  308.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  309.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  310.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  311.  * SUCH DAMAGE.
  312.  */
  313.  
  314. Some sections of the gopher code are modified versions of existing
  315. software. I include the copyright notices attached to that software below.
  316.  
  317. * The Resolver routines *
  318.  
  319. /*
  320.  * Copyright (c) 1985, 1988 Regents of the University of California.
  321.  * All rights reserved.
  322.  *
  323.  * Redistribution and use in source and binary forms, with or without
  324.  * modification, are permitted provided that the following conditions
  325.  * are met:
  326.  * 1. Redistributions of source code must retain the above copyright
  327.  *    notice, this list of conditions and the following disclaimer.
  328.  * 2. Redistributions in binary form must reproduce the above copyright
  329.  *    notice, this list of conditions and the following disclaimer in the
  330.  *    documentation and/or other materials provided with the distribution.
  331.  * 3. All advertising materials mentioning features or use of this software
  332.  *    must display the following acknowledgement:
  333.  *    This product includes software developed by the University of
  334.  *    California, Berkeley and its contributors.
  335.  * 4. Neither the name of the University nor the names of its contributors
  336.  *    may be used to endorse or promote products derived from this software
  337.  *    without specific prior written permission.
  338.  *
  339.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  340.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  341.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  342.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  343.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  344.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  345.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  346.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  347.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  348.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  349.  * SUCH DAMAGE.
  350.  */
  351.  
  352. * Misc utility routines (from Xgopher) *
  353.  
  354. * Allan Tuchman, University of Illinois at Urbana-Champaign     
  355. *                Computing and Communications Services Office   
  356. * Copyright 1992 by                                             
  357. *           the Board of Trustees of the University of Illinois 
  358. * Permission is granted to freely copy and redistribute this    
  359. * software with the copyright notice intact.                    
  360.  
  361.  
  362.  
  363.  
  364.  
  365.